{\rtf1\mac\ansicpg10000\cocoartf824\cocoasubrtf420
{\fonttbl\f0\fswiss\fcharset77 Helvetica;\f1\fswiss\fcharset77 Helvetica-Bold;\f2\fswiss\fcharset77 Helvetica-Oblique;
}
{\colortbl;\red255\green255\blue255;}
\margl1440\margr1440\vieww15380\viewh13340\viewkind0
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural

\f0\fs24 \cf0 \
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural

\f1\b \cf0 NEW:
\f0\b0 \
Please consider installing the "mpstats" port to opt in to contributing anonymous information about your system and installed ports. The statistics collected can be viewed with our new {\field{\*\fldinst{HYPERLINK "https://ports.macports.org/"}}{\fldrslt online ports database}}.\
\
\

\f1\b \cf0 What is MacPorts?
\f0\b0 \
\
MacPorts provides an infrastructure for building, installing, and packaging open source software. It is designed to match the functionality of the FreeBSD Ports system and to be extensible for future enhancements.\
\

\f1\b \
System Requirements:
\f0\b0 \
\
This installer is built for macOS __XVERS__.x and requires valid curl and OpenSSL installations to function - all present by default on macOS. We recommend you install the Xcode Command Line Tools by running "xcode-select --install" in your terminal. Also required, for most GUI applications, is the installation of Apple's Xcode development suite, available from the Mac App Store or from {\field{\*\fldinst{HYPERLINK "https://developer.apple.com/xcode/"}}{\fldrslt Apple's Developer site}}. It is also available as a separate installation on Mac OS X CDs and DVDs.\
\
\

\f1\b Install Location:\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural

\f0\b0 \cf0 \
The MacPorts installer copies MacPorts to the target directory __PREFIX__. If you wish to install to any path other than that, you must install MacPorts via its source code. See {\field{\*\fldinst{HYPERLINK "https://www.macports.org/install.php"}}{\fldrslt Installing MacPorts}} on the MacPorts webpage for instructions on installation alternatives.\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural

\f1\b \cf0 \
\
What is Installed:\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural

\f0\b0 \cf0 \
Aside from a few MacPorts executable commands in __PREFIX__/bin, most MacPorts files are installed in __PREFIX__/var/macports. Within these directories you will find a "sources" directory containing the Portfiles that hold the necessary instructions to install individual ports, and also the source code for MacPorts itself. Both are kept up to date by using the 
\f2\i port selfupdate
\f0\i0  command as shown below. Please read the port(1) man page for more information.\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural

\f1\b \cf0 \
\
Shell Environment:
\f0\b0 \
\
A file named ~/.profile is created for the "bash" shell (default on Mac OS X 10.3 and newer) during the MacPorts installation. It contains the necessary statements to append MacPorts' binary paths within __PREFIX__/ to your shell environment, so MacPorts is available to you on subsequent terminal sessions. You may have to quit and restart your terminal application for this change to take effect.\
\

\f1\b \
Basic Usage:\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural

\f0\b0 \cf0 \
The main user interface to MacPorts is the 
\f2\i port
\f0\i0  command and the various facilities it provides for installing ports. The first thing you should do after you install MacPorts is to make sure it is fully up to date by pulling the latest revisions to the Portfiles and any updated MacPorts base code from our rsync server, all accomplished simply by running the 
\f2\i port selfupdate 
\f0\i0 command as the Unix superuser:\
\
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural
\cf0 	
\f2\i sudo port selfupdate 
\f0\i0 \
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural
\cf0 \
Running this command on a regular basis is recommended -- it ensures your MacPorts installation is always up to date. Afterwards, you may search for ports to install:\
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural
\cf0 \
	
\f2\i port search <portname>
\f0\i0 \
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural
\cf0 \
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural
\cf0 where 
\f2\i <portname>
\f0\i0  is the name of the port you are searching for, or a partial name. To install a port you've chosen, you need to run the 
\f2\i port install
\f0\i0  command as the Unix superuser:\
\
	
\f2\i sudo port install <portname> 
\f0\i0 \
\
where now 
\f2\i <portname>
\f0\i0  maps to an exact port name in the ports tree, such as those returned by the 
\f2\i port search 
\f0\i0 command
\f2\i . 
\f0\i0 Please consult the port(1) man page for complete documentation for this command and the software installation process.\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural

\f1\b \cf0 \
\
Documentation:\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural

\f0\b0 \cf0 \
The {\field{\*\fldinst{HYPERLINK "https://guide.macports.org"}}{\fldrslt MacPorts Guide}} and {\field{\*\fldinst{HYPERLINK "https://trac.macports.org/wiki"}}{\fldrslt MacPorts Wiki}} should be consulted for further documentation and support. Also provided are man pages for 
\f2\i port
\f0\i0 , 
\f2\i macports.conf
\f0\i0 , 
\f2\i portfile
\f0\i0 , 
\f2\i portgroup
\f0\i0 , 
\f2\i portstyle
\f0\i0 , and 
\f2\i porthier
\f0\i0 . These can be invoked by typing: "man" followed by the name of the command or file (e.g. "man port" or "man macports.conf").\
\
\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural

\f1\b \cf0 Creating New Ports:\
\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural

\f0\b0 \cf0 If you are interested in developing your own ports for private usage, or would like to submit your ports for inclusion within the MacPorts software repository, please consult the documentation provided on our website. The MacPorts project depends on a community of active participants and we are always open to welcoming new volunteers and their contributions!\
\
Thank you for your interest in MacPorts!\
}
